home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / skill29.zip / SPOTKILL.DOC < prev    next >
Text File  |  1993-05-30  |  19KB  |  363 lines
  1.                         ┌─────────────────────────┐
  2.                         │      Spot Kill 2.9      │
  3.                         └─────────────────────────┘
  4.  
  5.  
  6.                              !!!! WARNING !!!!
  7.   !!   This Program Is Designed for GT 16.00 and Higher Specifically   !!
  8.   !!   Use on any other version could prove hazardous to your system   !!
  9.  
  10.        ──────────────────────────────────────────────────────────────
  11.                                   History
  12.        ──────────────────────────────────────────────────────────────
  13.  
  14.          01-26-92   Ver 1.0 Initial Release
  15.          01-29-92   Ver 1.1 Added 'ANY' argument to "Search Area" and
  16.                     "Flags"
  17.          02-02-92   Ver 1.2 Added /P: Parameter to Command Line.
  18.                     (Ability to search Alternate Echo Path)
  19.          02-03-92   Ver 1.3 Added /C: Parameter to Command Line.
  20.                     (Ability to specify Alternate Config File)
  21.          02-08-92   Ver 1.4 Added Result Logging.  Unless a /NL is
  22.                     placed on the command line SPOTKILL will write a
  23.                     progress log to a file called SPOTKILL.LOG in the
  24.                     GTPATH directory.
  25.          04-05-92   Ver 1.5 Added ALL Argument to the "FLAGS" area of
  26.                     the CFG file.  If you add ALL to the "FLAGS" area
  27.                     every message meeting the "Search Area" and  "Text
  28.                     Search" parameter WILL be deleted whether it has
  29.                     been bagged or received.  USE WITH CAUTION!
  30.          11-07-92   Version 1.6  SpotKill has received an overhaul.
  31.                     ALL command line parameters are now obsolete, they
  32.                     are no longer needed as the configuration file has
  33.                     been almost completely redesigned.  Please read the
  34.                     WHATS.NEW file for upgrade information.
  35.          11-08-92   Version 1.7  This release fixes some minor bugs
  36.                     that was found in version 1.6.  Corrections include
  37.                     ability to use /REGISTER with the QWK compatible
  38.                     GTMDIR.BBS and corrected a never ending loop that
  39.                     would happen if the last END statement was not
  40.                     placed into the SPOTKILL.CNF.
  41.          11-09-92   Version 1.8  Improved result logging.  SPOTKILL
  42.                     now puts the date (the correct one which was fixed),
  43.                     the message are being processed, and a listing of
  44.                     all messages deleted.  SPOTKILL also reports if no
  45.                     messages were deleted in the log file.
  46.          12-06-92   Version 1.9  Several Additional and Modified Flags,
  47.                     as well as some feature changes.  The two new flags
  48.                     for SpotKill are INCOMING and IN_RECEIVED.  You can
  49.                     now specify the message to be an INCOMING message
  50.                     or an INCOMING/RECEIVED message prior to deletion.
  51.                     Three flags have been renames ALL is now KILL_ALL,
  52.                     ANY is now ANY_STAT and BOTH is now BOTH_STAT.  In
  53.                     the search location the ANY has changed to ANY_LOC.
  54.                     SpotKill will now also allow you to Mark Messages
  55.                     as bagged rather than completely deleting them.
  56.                     If you would prefer to simply mark your offending
  57.                     message as bagged rather than kill them, place a
  58.                     /MB (mark bagged) on the command line.
  59.          12-27-92   Version 2.0  Some additions have been made at the
  60.                     suggestion of Bob Butcher.  The first change is the
  61.                     addition of the "Message - O - Meter".  The "meter"
  62.                     will give you graphic representation of the percentage
  63.                     of the message base that has been scanned, and how
  64.                     much remains.  The second addition is the ability to
  65.                     make three distinct "breaks" out of the program.
  66.                     Listed at the top of the screen you will notice that
  67.                     the F1 F2 and F3 keys will allow you to break out of
  68.                     the various Spotkill Loops.  F1 will break out of the
  69.                     current search and continue with the next search in the
  70.                     message area.  F2 will tell Spotkill to continue on to
  71.                     the next message area.  F3 will do a graceful and
  72.                     immediate exit from the program.
  73.           2-01-93   Version 2.1  Two new features have been added to
  74.                     SPOTKILL.  SPOTKILL can now GLOBALLY process each
  75.                     message area listed in the GTMDIR.BBS file.  To force
  76.                     a GLOBAL process, place the word GLOBAL in the
  77.                     SPOTKILL.CNF file instead of a PATH to the message
  78.                     area.  When SpotKill see's GLOBAL as the pathname, each
  79.                     and every message area listed in the GTMDIR.BBS file
  80.                     will be searched.  SPOTKILL also has a new command line
  81.                     parameter /NOMETER.  If you don't want to see
  82.                     SpotKill's MESSAGE - O - METER use /NOMETER.
  83.           2-02-93   Version 2.2  Bug Fix.  Corrected Problem reading
  84.                     GTMDIR.BBS
  85.           2-03-93   Version 2.3  Bug Fix.  Corrected Problem in the F1
  86.                     (Skip Current Search) routine.  Thanks to Bob Butcher
  87.                     for catching this one (one day late though ).
  88.           2-14-93   Version 2.4  Added Alternate Config File Command Line
  89.                     Option.  If you wish to use a Config FIle other than
  90.                     <GTPATH>\HOTWARE\SPOTKILL.CNF then you can specify a
  91.                     /C:<ALT_CONFIG> where <ALT_CONFIG> is the full path and
  92.                     filename of the file you wish to use for the
  93.                     configuration file.
  94.           3-07-93   Version 2.5  Now only the message areas that actually
  95.                     have messages deleted or marked bagged will be logged
  96.                     into the SPOTKILL.LOG.  No more searching the log
  97.                     file in search of actual work....
  98.           3-15-93   Version 2.6  Corrected a problem with '#' as a flag in
  99.                     the GTMDIR.BBS file.
  100.           5-21-93   Version 2.7  Never Really Released.
  101.           5-22-93   Version 2.8  hopefully corrected a problem some folks
  102.                     were encountering with Stack Overflow problems.  This
  103.                     version will also put the name of the echo on the
  104.                     screen rather than the path of the echo when working in
  105.                     GLOBAL mode.
  106.           5-30-93   Version 2.9  corrected a problem with the LOGGING
  107.                     feature.  SPOTKILL was not logging correctly when in
  108.                     GLOBAL mode.
  109.  
  110.  
  111.        ──────────────────────────────────────────────────────────────
  112.                                 What is It?
  113.        ──────────────────────────────────────────────────────────────
  114.          A simple little program that will go to your netmail message
  115.          area and "Spot Kill" (or just mark them as bagged if you prefer)
  116.          any messages you choose.  SPOTKILL reads from a configuration file
  117.          (discussed below) and deletes selectively by Message Sender,
  118.          Receiver, or Subject.  In the config file you must specify the
  119.          path of the message area to process, whether the message has to be
  120.          Received, Bagged, Incoming Any_Stat (Bagged or Received),
  121.          Both_Stat (Bagged AND Received), or IN_Received (Incoming message
  122.          that has been received). Any messages that are found must match
  123.          the text you have chosen to search for and the bagged / received /
  124.          incoming flag combinations before the message will in any way be
  125.          removed. Bear in mind however the text you choose will be searched
  126.          for in a case insensitive manner.  If the text appears ANYWHERE in
  127.          the section you have chosen to search (Sender Receiver or Subject)
  128.          the message will be subject to deletion.  For example, if you
  129.          choose to delete any Received messages with "NET" in the subject,
  130.          the following Subject lines would be subject to deletion: Netmail
  131.          System Report Net 064 Discussions FIDONETWORK Expo
  132.  
  133.          As you can see, if NET appears ANYWHERE in the text and the
  134.          Received flag was set on the message, this message would be
  135.          history.
  136.  
  137.  
  138.        ──────────────────────────────────────────────────────────────
  139.                                   Why Is It?
  140.        ──────────────────────────────────────────────────────────────
  141.  
  142.          You may be asking about now, Why would you want to do this?
  143.          It's simple.  On my system, there are several messages that
  144.          travel through concerning, Automated File Attach Messages,
  145.          Netmail Reports, Echo Requests, etc.  With SPOTKILL I can
  146.          automatically remove these type messages automatically each night
  147.          after they have either been bagged or received without any manual
  148.          intervention.
  149.  
  150.        ──────────────────────────────────────────────────────────────
  151.                                  Execution..
  152.        ──────────────────────────────────────────────────────────────
  153.          Running the program is very easy.  The only things that are
  154.          required are: 1. A valid GTPATH statement,  2. SPOTKILL.CNF
  155.          located in <GTPATH>\HOTWARE directory. (described below).
  156.  
  157.          Now for this SPOTKILL.CNF file:
  158.  
  159.          SPOTKILL.CNF may contain information for an unlimited number of
  160.          message areas.  Each section is divided by the word END.  The
  161.          start of each Message Area section must start with the full path
  162.          of the message area to process OR the word GLOBAL.  If GLOBAL is
  163.          used SpotKill will read the GTMDIR.BBS file in your GTPATH and
  164.          execute on each valid message area.  Following the full path
  165.          SPOTKILL will read two lines for each "Text Search" that will take
  166.          place.  The number of searches that SPOTKILL can perform on each
  167.          run is unlimited.  The format of the file looks like this, (The
  168.          offsets after the text search is optional, although suggested for
  169.          easier readability of your .CNF file):
  170.  
  171.          E:\GTMAIL\NETMAIL
  172.            "Text To Search For"
  173.               "Search Area"  "Flags"
  174.          END
  175.  
  176.          A practical Example:
  177.  
  178.          E:\GTMAIL\NETMAIL
  179.            GT-TOOLS
  180.              SENDER BAGGED
  181.            ECHOMAIL REPORT
  182.              SUBJECT RECEIVED
  183.            ROB ROESCH
  184.              RECEIVER BOTH_STAT
  185.            NETMAIL SYSTEM
  186.              ANY_LOC ANY_STAT
  187.          END
  188.          GLOBAL
  189.            SPONSOR
  190.              RECEIVER KILL_ALL
  191.          E:\GTMAIL\NETMAIL2
  192.            GT-TOOLS
  193.              SENDER BAGGED
  194.          END
  195.  
  196.          The above example would make four passes through the message area
  197.          E:\GTMAIL\NETMAIL.  The first Pass would look for the text
  198.          "GT-TOOLS" (case insensitive) in the Sender section of the
  199.          message.  If this was found, SPOTKILL would look to see if the
  200.          message had been bagged, and if so the message would be deleted.
  201.          If the message had not yet been bagged, the message would NOT be
  202.          deleted.  The second pass would look for "ECHOMAIL REPORT" (again
  203.          case insensitive) only this time the text would be looked for in
  204.          the Subject of the message.  If "ECHOMAIL REPORT" were found
  205.          anywhere in the Subject of the message, and the message had been
  206.          marked as received the message would be deleted.  On the third
  207.          pass "Rob Roesch" would be searched for in the Receiving section
  208.          of the message.  If "Rob Roesch" is found the message must be BOTH
  209.          received and bagged before the message will be deleted.  On the
  210.          fourth pass, if "NETMAIL SYSTEM" were found in ANY of the three
  211.          areas (Sender, Receiver, or Subject) and either the BAGGED >OR<
  212.          RECEIVED flags were set, the message would be deleted.  After
  213.          E:\GTMAIL\NETMAIL was completely processed SPOTKILL would start
  214.          the process again only this time GLOBALLY for each message area
  215.          found in the GTMDIR.BBS file.  SpotKill will search each message
  216.          area looking for SPONSOR in the Receiver section of the message
  217.          header.  After the GLOBAL process is complete SPOTKILL would start
  218.          in the message area E:\GTMAIL\NETMAIL2. Please note that END (starting in column 1)
  219.          separates the three sections.  Without the END statement
  220.          SPOTKILL will not know to start processing the next message area.
  221.  
  222.          Valid "Search Area" arguments are:
  223.  
  224.                SENDER  RECEIVER  SUBJECT  ANY_LOC
  225.  
  226.          Nothing else will be recognized and the program will exit with an
  227.          error.
  228.  
  229.          Valid "Flags" arguments are:
  230.  
  231.               BAGGED  RECEIVED  BOTH_STAT  ANY_STAT  KILL_ALL
  232.                           INCOMING    IN_RECEIVED
  233.  
  234.                  BAGGED      Any BAGGED message meeting the "Text Search"
  235.                              criteria will be deleted.
  236.                  RECEIVED    Any RECEIVED message meeting the "Text Search"
  237.                              criteria will be deleted.
  238.                  BOTH_STAT   Any BAGGED *AND* RECEIVED message meeting the
  239.                              "Text Search" Criteria will be deleted.
  240.                  ANY_STAT    Any BAGGED  *OR* RECEIVED message meeting the
  241.                              "Text Search" criteria will be deleted.
  242.                  INCOMING    Any INCOMING messages meeting the "Text
  243.                              Search" criteria will be deleted.
  244.                  IN_RECEIVED Any INCOMING messages, that have be previously
  245.                              received AND meed the "Text Search" criteria
  246.                              will be deleted.
  247.                  KILL_ALL    >>ALL<<  messages meeting the "Text Search"
  248.                              criteria will be deleted.  USE WITH CAUTION!
  249.  
  250.          Nothing else will be recognized and the program will exit with an
  251.          error.
  252.  
  253.  
  254.          Note:  SPOTKILL.CNF  MUST be in a directory off your GTPATH
  255.                 directory named HOTWARE.  ie. if your GTPATH is set
  256.                 to C:\GT then SPOTKILL.CNF must be in C:\GT\HOTWARE
  257.  
  258.        ──────────────────────────────────────────────────────────────
  259.                           Command Line Parameters
  260.        ──────────────────────────────────────────────────────────────
  261.          There's five.
  262.  
  263.              /LOG
  264.  
  265.          If you want SPOTKILL to keep a log file of the messages that
  266.          were deleted simply put /LOG on the command line.
  267.  
  268.              /MB
  269.  
  270.          If you want SPOTKILL to mark messages as bagged rather than
  271.          delete them, put a /MB (Mark Bagged) on the command line.  No
  272.          message will be deleted, but they won't travel off your BBS
  273.          either.
  274.  
  275.              /NOMETER
  276.  
  277.          If you would like to shut of SpotKill's Message - O - Meter,
  278.          use this parameter.  SPOTKILL will execute somewhat faster
  279.          without the meter, and besides if your running it automatically
  280.          at midnight, why would you want the meter there....
  281.  
  282.               /C:<ALT_CONFIG>
  283.  
  284.          If you wish to use a Config FIle other than
  285.          <GTPATH>\HOTWARE\SPOTKILL.CNF then you can specify a
  286.          /C:<ALT_CONFIG> where <ALT_CONFIG> is the full path and filename
  287.          of the file you wish to use for the configuration file.
  288.  
  289.              /REGISTER
  290.  
  291.          If you would like to use the Auto Registration feature of
  292.          SPOTKILL, use this parameter.  SPOTKILL will send a registration
  293.          message to ROB ROESCH at 064/003 via netmail when this parameter
  294.          is used.
  295.  
  296.        ──────────────────────────────────────────────────────────────
  297.                            Active Keyboard Input
  298.        ──────────────────────────────────────────────────────────────
  299.  
  300.          Spotkill has the ability to exit various levels of execution at
  301.          your request.  There are three distinct "breaks" out of the
  302.          program.  Listed at the top of the execution screen you will
  303.          notice that the F1 F2 and F3 keys will allow you to break out of
  304.          the various Spotkill Loops.  F1 will break out of the current
  305.          search and continue with the next search in the message area.
  306.          F2 will tell Spotkill to continue on to the next message area.
  307.          F3 will do a graceful and immediate exit from the program.
  308.  
  309.        ──────────────────────────────────────────────────────────────
  310.                                  Errorlevels
  311.        ──────────────────────────────────────────────────────────────
  312.          Here are the possible errorlevel exits the program will give.
  313.       
  314.                   ERRORLEVEL 0  No Problems, Good Run.....
  315.                   ERRORLEVEL 1  GTPATH Not Set
  316.                   ERRORLEVEL 2  Cannot find SPOTKILL.CNF
  317.                   ERRORLEVEL 3  Cannot Open GTMDIR.BBS
  318.                   ERRORLEVEL 4  Cannot Find NETMAIL Area in GTMDIR.BBS
  319.                   ERRORLEVEL 5  Cannot Open MESSAGE.CTL
  320.  
  321.  
  322.        ──────────────────────────────────────────────────────────────
  323.                                 Registration
  324.        ──────────────────────────────────────────────────────────────
  325.  
  326.         I am not requesting any money for this program, but I would
  327.         not turn any down either <g>.  If you want to slip $5.00 into
  328.         and envelope I'll accept it.  Although I don't require a
  329.         registration fee I would appreciate knowing that you are using
  330.         the program on a normal basis.  Therefore I have provided a
  331.         simple and easy way for you to register this program.  From
  332.         the DOS prompt type:   
  333.  
  334.  
  335.          SPOTKILL /REGISTER
  336.  
  337.       SPOTKILL will the proceed to send me a netmail message informing me
  338.       that you are using the program.  Please use this feature ONCE.
  339.  
  340.  
  341.        ──────────────────────────────────────────────────────────────
  342.                             Who Is Responsible for This?
  343.        ──────────────────────────────────────────────────────────────
  344.                                  Rob Roesch
  345.                               The HOTware BBS
  346.                          GT Power Net-Node 064/003
  347.                                 Rt 7 Box 566
  348.                            Mocksville, NC  27028
  349.                          704-492-2081 (USR 16.8 DS)
  350.  
  351.           If you start using this utility, and get a chance, let me know 
  352.           (see above procedures.  If you don't have any use for it, delete
  353.           it for your total refund of all the disk space that it was
  354.           occupying.  This program comes with no warranty, no guarantee,
  355.           and no promises.  If it works GREAT, if not let me know and I
  356.           will gladly take a look at it in my spare time.  If you really
  357.           really really like the program and want to make any donations,
  358.           feel free, but it is not a requirement.....
  359.  
  360.  
  361.  
  362.  
  363.